cs-senda-sapi icon

cs-senda-sapi

(0 reviews)

📘 Documentación de la API - cs-senda-sapi

Esta sección describe los atributos y uso del servicio cs-senda-sapi.

💂️ Información Base

  • Título de la API: cs-senda-sapi
  • Versión: 1.0.0
  • URL Base: https://senda-api-prod.us-e1.cloudhub.io/api/Reemplaza el segmento de ambiente con:
  • dev (Desarrollo)
  • qa (Aseguramiento de Calidad)
  • prod (Producción)

🔑 Autenticación

Encabezados Requeridos

EncabezadoTipoDescripción
client_idStringIdentificador único para clientes de API
  • client_id
    • Longitud: 32 - 36 caracteres
    • Ejemplo: 123e4567-e89b-12d3-a456-426614174000

      📌 Este encabezado es requerido en todas las solicitudes.


🔒 Endpoint: Crear Autorización

POST /authorization
- Descripción: Crea una nueva autorización para servicios médicos.

URL Completa

https://senda-api-prod.us-e1.cloudhub.io/api/authorization

Método HTTP

POST

Encabezados Requeridos

client_id: TU_CLIENT_ID
Content-Type: application/json

Autenticación

Aplicación de Client ID

Cuerpo de Solicitud

{
  "patientInfo": {
    "documentType": "1",
    "documentNumber": "1234567890",
    "firstName": "John",
    "lastName": "Doe",
    "birthDate": "1980-05-15",
    "gender": "M",
    "phone": "3107894561",
    "email": "john.doe@example.com"
  },
  "serviceInfo": {
    "serviceType": "1",
    "serviceCode": "MED-001",
    "description": "General medical consultation",
    "urgency": "medium",
    "requestDate": "2025-05-01T10:30:00Z"
  },
  "contractInfo": {
    "contractId": "CON-12345",
    "planType": "PREMIUM",
    "company": "ABC Company"
  }
}

Ejemplo de Solicitud

curl -X POST "https://senda-api-prod.us-e1.cloudhub.io/api/authorization" \
-H "client_id: TU_CLIENT_ID" \
-H "Content-Type: application/json" \
-d '{
  "patientInfo": {
    "documentType": "1",
    "documentNumber": "1234567890",
    "firstName": "John",
    "lastName": "Doe",
    "birthDate": "1980-05-15",
    "gender": "M",
    "phone": "3107894561",
    "email": "john.doe@example.com"
  },
  "serviceInfo": {
    "serviceType": "1",
    "serviceCode": "MED-001",
    "description": "General medical consultation",
    "urgency": "medium",
    "requestDate": "2025-05-01T10:30:00Z"
  },
  "contractInfo": {
    "contractId": "CON-12345",
    "planType": "PREMIUM",
    "company": "ABC Company"
  }
}'

Ejemplo de Respuesta

{
  "authorizationId": "AUTH-987654",
  "status": "APPROVED",
  "creationDate": "2025-05-01T10:35:22Z",
  "expirationDate": "2025-05-31T23:59:59Z",
  "message": "Authorization successfully created",
  "provider": {
    "id": "PROV-001",
    "name": "Centro Médico Nacional",
    "address": "Avenida Principal #123",
    "phone": "6014567890"
  }
}

⚠️ Códigos de Error

CódigoDescripciónSolución Sugerida
400Solicitud IncorrectaRevisar sintaxis de solicitud y parámetros
401No AutorizadoValidar credenciales de autenticación
404No EncontradoConfirmar la URL del endpoint
500Error Interno del ServidorReintentar o contactar soporte técnico

📞 Soporte

Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.

Correo electrónico: epalma@fgs.co

📅 Información Adicional

  • Documentación actualizada por última vez: Agosto 2025
  • Para actualizaciones adicionales, consulta el Portal de Exchange de API

Documentación actualizada en julio 2025 por epalma@fgs.co - Edna Nayibe Palma

© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-senda-sapi


Reviews